home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / STUTTGART / UTIL / FILEUTIL / DISCSPACE / !DiscSpace / !Help < prev    next >
Text File  |  1995-01-31  |  6KB  |  125 lines
  1. DiscSpace 1.09 (31-Jan-1995)
  2.  
  3. Purpose: display of graphical disc usage statistics for directories
  4. Author:  Martin Wuerthner
  5.          Jahnstrasse 18
  6.          71116 Gaertringen
  7.          (Germany)
  8.          e-mail: wuerthne@minnie.informatik.uni-stuttgart.de
  9. Runs under: RISC OS 2 or higher
  10.             supports RISC OS 3 image files and DragASprite
  11. Status: FREEWARE (see below)
  12.  
  13. New in 1.09: It works! (Sorry for those who downloaded 1.08, which
  14.              had more new bugs introduced than old ones removed)
  15.  
  16. New in 1.07: Works better with ArcFS as it was slightly modifies to
  17.              cope with a small ArcFS bug. This bug caused DiscSpace
  18.              to fail with 'Directory not found' and 'Bad OS_GBPB call'
  19.              errors when scanning ArcFS archives.
  20.  
  21. What is does:
  22. -------------
  23.  
  24. Have you ever wondered where all the free space on your hard disc has
  25. gone? Do you want to know which directories consume most of your hard
  26. disc space without having to count each directory using the filer?
  27.  
  28. This application shows a diagram of disc usage, displaying a bar for
  29. each directory. The whole directory tree is cached so you can open
  30. subdirectories similar to using a filer window.
  31.  
  32. How to use it:
  33. --------------
  34.  
  35. The main menu item 'Count' leads to a standard RISC OS save box. Drag
  36. the 'filer window icon' to the directory you are interested in (e.g.
  37. the root directory of a drive).
  38.  You may also simply drag a directory to the icon bar icon of the
  39. application. This is the easier way as long as you don't want to
  40. scan the root directory of a drive.
  41.  DiscSpace scans the directory and all its subdirectories displaying
  42. some kind of FilerAction window (offering the menu options 'Faster'
  43. and 'Verbose' like the real FilerAction window). Note that counting
  44. may take some time if the chosen directory is a top-level one.
  45.  
  46. Having finished the 'Count' operation, DiscSpace displays a window
  47. which shows a 'Total' bar for the whole directory and a bar for each
  48. subdirectory indicating how much disc space it consumes. By
  49. double-clicking on a subdirectory, it is opened and the window is
  50. replaced by a display of the corresponding subdirectory. By chosing
  51. 'Open parent' from the menu or by Adjust-clicking on the Close icon,
  52. you can go up one level in the directoy tree (but no further up if yor
  53. are at your starting directory).
  54. By default files are not shown in the window. Instead, there is one
  55. item which shows how much space all the files in the directory consume
  56. together. If you double-click on this item or choose 'Show files' from
  57. the menu, this item is replaced by one item for each file in the
  58. directory. Double-clicking on any of these file icons or choosing
  59. 'Show Files' again switches back to the original display mode. By
  60. choosing 'Open filer' from the menu, a filer window on the currently
  61. displayed directory is opened.
  62. Choose 'Rescan' from the menu to have the directory scanned again
  63. (useful if you have deleted objects in the meantime).
  64. The current limit for file and directory names is 12 characters.
  65. This corresponds to the limits of RISC OS (FileCore) and DOS file names.
  66. Longer file names are simply truncated, longer directory names cause
  67. the application to fail when trying to display the window for such
  68. a directory.
  69.  
  70. The main menu item 'Images' determines whether DiscSpace also scans
  71. the directory trees of image files (DOSDisc files or archives when
  72. used with !SparkFS). If it is not ticked, images are treated as files.
  73. The displayed size of an image file is always the size of the file
  74. (not the sum of the sizes of the objects inside the image). So for a
  75. DOSDisc image, the overall size usually differs from the sum of the
  76. sizes of the objects inside (as there may be unused space inside the
  77. image).
  78.  
  79. DiscSpace uses outline fonts wherever possible (i.e. for all icons
  80. and menus). If you do not want this feature or if your version of the
  81. WindowManager already uses outline fonts instead of the system font,
  82. you may switch it off by commenting out the following line in the !Run
  83. file:
  84.   Set DiscSpace$UseFont TRUE
  85. or by setting the variable to FALSE.
  86.  
  87. If the application is used on a RISC PC (i.e. under RISC OS 3.5 or higher),
  88. this option is set to FALSE automatically.
  89.  
  90. You may change the font to be used and its size by modifying the
  91. lines:
  92.   Set DiscSpace$Font ...
  93.   SetEval DiscSpace$FontWidth ...
  94.   SetEval DiscSpace$FontHeight ...
  95. to suit your own taste. Note that if the font is not found, the
  96. application reverts to using the system font.
  97.  
  98. History:
  99.   version 1.03 (05-Feb-1994): - first version sent to Hensa
  100.   version 1.04 (10-Feb-1994): - fixed bug:
  101.                               - Rescan took the currently displayed directory
  102.                                 as starting directory for the scan instead of
  103.                                 the previous starting directory
  104.   version 1.05 (17-Aug-1994): - switches UseFont off if run under RO 3.5 or higher
  105.                               - contains style guide compliant templates (RO3 only)
  106.   version 1.06 (23-Aug-1994): - accepts a directory dragged to the icon bar
  107.                               - contains sprites for iconised windows
  108.   version 1.07 (19-Dec-1994): - contains code to work around a small bug in ArcFS 2
  109.                                 (still present in current version which is 0.71)
  110.   version 1.08 (26-Jan-1995): - minor bug fix
  111.   version 1.09 (31-Jan-1995): - Sorry, forgot a file in 1.08 (Templates3)
  112.                               - also forgot to change the Templates after a major
  113.                                 library revision (changed the way fonts in icons
  114.                                 are handled)
  115.  
  116. To do:
  117.   - allow multiple windows (like the filer)
  118.   - allow multiple directory trees
  119.   - cope with longer file leaf names
  120.  
  121. This application is FREEWARE, i.e. it may be copied freely provided
  122. that all files are distributed together and that none of them is
  123. changed. Distribution is only allowed if it is not for profit or
  124. after prior arrangement with the author.
  125.